home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / utils / frmdo12d.lzh / FORMDOIT.TXT < prev    next >
Text File  |  1991-08-10  |  19KB  |  410 lines
  1.                         FormDoIt! (Version 1.2d)
  2.                              by Dan Wilga
  3.  
  4.         Copyright © 1991, Gribnif Software.  All Rights Reserved.
  5.  
  6. This program may be distributed without charge, provided that this text
  7. file is present and that it and the program files are unmodified.
  8.  
  9.  
  10. Overview
  11. --------
  12.  
  13.   The FormDoIt! program replaces the parts of the GEM environment that
  14.   handles the standard dialog and alert boxes that appear in most Atari
  15.   programs.  Enhancements that FormDoIt! offers include:
  16.  
  17.   o Keyboard Equivalents for dialog and alert box buttons.
  18.   o [Undo] key to exit dialog and alert boxes.
  19.   o Enhanced editable text fields.
  20.   o Ability to insert extended characters into editable text fields.
  21.   o Editable alert box icons.
  22.   o Control over the default exit button in alerts and dialogs.
  23.  
  24.  
  25. Included Files
  26. --------------
  27.  
  28.   This archive should include the following files:
  29.  
  30.     1.  FORMDOIT.PRG  - The FormDoIt! utility.
  31.     2.  FORMDOIT.TXT  - The file you are reading now.
  32.  
  33.     3.  ENGLISH .UND  - Sample English [Undo] keywords.
  34.     4.  GERMAN  .UND  - Sample German [Undo] keywords.
  35.     5.  DEFAULT .BL3  - FormDoIt! default alert box icons.
  36.     6.  BORING  .BL3  - Original system alert box icons.
  37.     7.  INVERSE .BL3  - Inverse version of original system alert box icons.
  38.  
  39.  
  40. Installation
  41. ------------
  42.  
  43.   Place the FORMDOIT.PRG in your system's AUTO folder.  Optionally, you
  44.   can also install it by running it from the desktop of your choice.
  45.  
  46.  
  47. Enhancements
  48. ------------
  49.  
  50.   Default Button
  51.   --------------
  52.  
  53.     Normally, if you press the [Return] key while in a dialog or alert box,
  54.     the "default" exit button is selected.  This button can usually be
  55.     identified by its extra thick border.
  56.  
  57.     With FormDoIt! you can change which of the exit buttons is considered
  58.     the default by holding down the [Alternate] key and pressing the [Tab]
  59.     key.  When you do this, you should see the thick border move from one
  60.     exit button to the next.
  61.  
  62.     This change is not permanent, many programs will automatically return
  63.     the default button back once you exit that dialog or alert box.
  64.  
  65.   Exit Button
  66.   -----------
  67.  
  68.     When using FormDoIt!, if you press the [Undo] key, the first button
  69.     found that contains the word "Cancel", "Quit", "Exit", "Abort", or "No"
  70.     will be selected.
  71.  
  72.     Since all buttons in a dialog and alert box are in an internal order,
  73.     it will choose the button that makes the first match (even if there is
  74.     more than one button with a string that matches).
  75.  
  76.     You can change the strings used by FormDoIt! for this feature by
  77.     creating a file called FORMDOIT.UND.  If FormDoIt! finds this file when
  78.     it first runs (in the same directory it was run from), the file
  79.     contents are used instead of the previous mentioned strings.  The file
  80.     is a simple text file with each button string on a line by itself.
  81.     There should be no empty lines in the file, and the carriage return
  82.     should immediately follow the last letter of each line.  The included
  83.     GERMAN.UND file can be renamed to FORMDOIT.UND if you happen to use
  84.     German programs.  If you wish to create your own custom FORMDOIT.UND
  85.     file, you can use the ENGLISH.UND as a guide.
  86.  
  87.   Buttons
  88.   -------
  89.  
  90.     FormDoIt! provides keyboard equivalents for all the other buttons in a
  91.     dialog or alert box.  FormDoIt! scans all the buttons in the dialog box
  92.     and assigns each one a unique keyboard equivalent.  When the dialog box
  93.     appears, it will look slightly different because there will be short
  94.     lines underneath characters in most of the buttons.  If you hold down
  95.     the [Alternate] key and press the character that is underlined, that
  96.     button will be selected.  Up to 20 buttons in a dialog can have
  97.     [Alternate] key assignments.
  98.  
  99.     The method for choosing which letter to assign to a specific button is
  100.     rather simple.  FormDoIt! scans all the buttons in order and looks for
  101.     the first unique character (that has not been used before) in that
  102.     button.  Once it finds it, it assigns it that key and underlines the
  103.     letter.  If a button has no unique characters (because they all were
  104.     already used in the dialog box) then it will not receive a keyboard
  105.     equivalent.  The scanning is done following the internal order of all
  106.     the dialog box buttons.
  107.  
  108.     If you don't like the "underline" keyboard equivalents, you can turn
  109.     this feature off.  This is done by holding down both [Shift] keys and
  110.     pressing the [Backspace] key.  You will hear a short sound effect
  111.     indicating your selection.  Pressing these keys again will turn the 
  112.     "underline" keyboard equivalents back on.
  113.  
  114.     See the "Configuration Options" section for more information on how to
  115.     more permanently turn this feature on or off.
  116.     
  117.     Some dialog boxes will look odd if these underscores are not undrawn
  118.     before control returns to the program that called FormDoIt. If this is
  119.     a concern, you can permanently configure FormDoIt to always undraw the
  120.     underscores. See the "Configuration Options" section.
  121.  
  122.   Alert Boxes
  123.   -----------
  124.  
  125.     When FormDoIt is active, you can not only use Alternate key combinations
  126.     to activate alert buttons, you can also use the 1, 2, 3, F1, F2, or F3
  127.     keys to choose a particular button within the alert. The buttons are
  128.     numbered, from left to right, 1 to 3.
  129.  
  130.     Alerts can be temporarily removed from the screen. Clicking with both
  131.     mouse buttons on any area other than a button will cause the alert box
  132.     to disappear. As soon as both buttons are released, the alert will appear
  133.     again. This is handy for situations where you want to see what is
  134.     "underneath" an alert.
  135.  
  136.     With FormDoIt! you can define what the standard alert box icons (stop
  137.     sign, question mark, and exclamation mark) look like.  Once you use
  138.     FormDoIt! you will see that it changes these (I got bored of the same
  139.     old ones).
  140.  
  141.     If FormDoIt! finds a file called FORMDOIT.BL3 at bootup, the icons
  142.     contained in that file are used in place of the default ones inside of
  143.     FormDoIt!.  Included with this program are three files:
  144.  
  145.     BORING .BL3 - These are the old standard GEM alert box icons.
  146.     DEFAULT.BL3 - These are the defaults FormDoIt! normally uses.
  147.     INVERSE.BL3 - These are an inverse version of DEFAULT.BL3.
  148.  
  149.     The .BL3 files are in Degas Elite block format.  They can be edited and
  150.     re-saved using Degas Elite.  If you edit them, you must be very careful
  151.     to make sure that the new file you save is a block that is exactly
  152.     32x96.  The "Snap" feature in Degas is helpful for this purpose.
  153.  
  154.   Editable Text Fields
  155.   --------------------
  156.  
  157.     An editable text field is a string within a dialog box that has a
  158.     vertical line cursor so that you can modify it with the keyboard.
  159.     FormDoIt! emulates the normal GEM dialog text field functions:
  160.  
  161.       o The [Tab] and down-arrow keys move to the next editable field.
  162.       o The up-arrow key moves to the previous editable field.
  163.       o The left and right-arrow keys move the cursor within a field.
  164.       o The [Esc] key clears an editable field.
  165.       o The [Backspace] and [Delete] keys delete characters before and
  166.         after the cursor.
  167.       o The mouse can be used to select an editable field.
  168.  
  169.     It also adds a number of extensions:
  170.  
  171.       o [Tab] and down-arrow will move the cursor to the first editable
  172.         field in a dialog box if it is already at the last one.
  173.       o Up-arrow will also wrap, from the first field to the last.
  174.       o [Shift] left-arrow will move the cursor to the leftmost character,
  175.         and [Shift] right-arrow will move all the way to the right.
  176.       o If there is no default button in a dialog box, the [Return] key
  177.         will advance the cursor to the next editable field.
  178.       o The mouse will position the cursor to the character closest to
  179.         where the mouse button was pressed, not just to the end of the
  180.         line.
  181.  
  182.     It also lets